Viewing a Knowledge Entry

There are three ways in which you can view knowledge entries - via the Knowledge Search window, via the Quick Search on the toolbar, or via the Knowledge Admin Search window. The first two methods open the Knowledge Entry window which is in 'reading' mode. The third method opens the Knowledge Entry Details window which is in edit mode.

 

If you are searching for an answer to a question or problem, use the Knowledge Search window or the Quick Search to view the knowledge entry.

 

Use the Knowledge Admin Search window if you need to update, moderate, or delete knowledge entries, or to find knowledge entries that are deleted or in draft. You will also find additional information about knowledge entries in the Information Panel, using this search.

 

Searching for Knowledge Entries

There are two ways in which you can search for knowledge entries - via the Knowledge Search window under the Search menu, and via the Quick Search on the toolbar. This section describes

Before you start

For text searching or external knowledge entries, the ASM Core Indexing service must be running.

If moderated is selected in the Knowledge Bank Settings, unmoderated knowledge entries will not be displayed.

You must have Search selected on the Options tab of your Knowledge Management security role.

Quick Search

  1. To the far right of the toolbar is the Quick Search box:   
  2. From the Quick Search menu select .
  3. Type the number and press Enter or select the button to display the knowledge entry on screen.

Knowledge Search

  1. Select and then Search.
  2. From the menu, select Knowledge Bank. The Knowledge Search window is divided into two panes. The Search Criteria pane is on the left where you enter search options. The main pane on the right displays the results of a search.
  3. Select your search criteria in the Knowledge Search Criteria pane on the left.
  4. The Options section contains fields that allow you to search on the following criteria:

    All Select to search for all types of knowledge entries.
    Abstract Select to search for entries that have the type set to Abstract
    Call Select to search for entries that have the type set to Call.
    Directory Select to search for entries that are Directory type
    FAQ Select to search for entries that have the type set to FAQ.
    KCS Select to search for KCS knowledge entries.
    Known Issue Select to search for knowledge entries that are Known Issues.
    Website Select to search for knowledge entries that are websites.
    Order By Select an option from the list to specify how your search results will be displayed. The search results are sorted and displayed based on the option selected. You can order your search results by Search Score, Rating, Most Recent or Profile.
    Include Deleted Field Values Select to include deleted values in the search criteria fields, that is, to search for a knowledge entry based on a value that may have been deleted.

    For example, if an Analyst who created a knowledge entry was deleted from the system, selecting this option adds the Analyst’s name to the list of people you can select in the Created By search field.

    The Knowledge Article Criteria section contains fields that allow you to search on the following criteria:

    Created By Start typing to search for the Analyst who created the knowledge entry and use this person as the criteria for your search
    Search Text Select this criterion to search for Knowledge Entries by typing in words or text the entry may contain.

    When you perform a knowledge search from a call, the call description is copied into the Search Text field, although the Search Text field itself is not selected as a criterion by which to search. This is by design, since running a search with a large number of words in the Search Text field will take a long time and most likely return no results. As such, if you want to use the call description in the knowledge search, you should review the words listed and then select the Search Text field so that it is used.

    The following options are available for text searches:

    You can choose between All Words and Any Words.

    You can choose between Exact, Related, Logical and Regular Expression.

    All Words

    Returns knowledge entries with words that match all the search text. However, it does not take into account the sequence of the words specified.

    Any Words

    Returns knowledge entries with one or more words that match the search text.

    Exact

    Returns knowledge entries in which the body text contains (any or all) words specified in the Search Text field, not necessarily in the same order.

    This type of search does not include an exact phrase search. To search for an exact phrase, the words for which you are searching must be specified within quotation marks.

    Nor will it retrieve text that has another form of the word or a synonym. For example, if you specify “Join” in text box, the search will not retrieve “Joined” as a match.

    Related Returns knowledge entries that contain synonyms or words that are similar to the search text. For example, if you search on “Cloning”, the search will locate entries such as “clone” and “cloned”.
    Logical

    Same behavior as Exact, however uses the SQL Server text searching engine instead of the vFire text search engine. Both require the vFire Indexing Service to be running.

    Regular Expression Returns knowledge entries with regular expressions associated with the search words, including wildcard characters such as an underscore (_) to represent one character or percentage (%) to represent zero or more characters.

    Wildcard characters are ignored if the Regular Expression option is not selected.

    Usage of regular expressions is specific to the database engine you are using: SQL Server or Oracle. Regular expressions are limited to searching for individual words and therefore exclude any punctuation and white space specified in the search text. The regular expression wildcard characters that ASM Core supports include:

    %to search for any string of zero or more characters.
    Use of this character at the beginning of a word by which you are searching is not supported. Furthermore, if using ‘%’ in the middle of a word, you should ensure that you always put ‘%’ at the end also. For example, col%r% will return color, colour
    _Any single character
    []Any single character within the specified range. For example, in the range [a-f] or in the set [abcdef]
    [^]Any single character not within the specified range. For example, not in the range [^a-f] or not in the set [^abcdef]

  5. You can add more fields to your search criteria. To do so, select at the top of the Knowledge Search Criteria pane and configure your search criteria.
  6. Select Search. The results are displayed in a browse table in the right hand pane, with the score (shown as a percentage) on the far right indicating how closely the entry matches the criteria. Each entry type is denoted by a specific icon. Searches for internal knowledge types (for example, Call, FAQ, etc) return a maximum of one result per entry. Searches for external knowledge types use the indexing process and return multiple entries or pages that are linked to the directory or website, respectively.  In this case, the entry itself is not returned in the search.
  7. You may see entries that do not appear to contain any of the search keywords entered. This is because each knowledge entry has Context, which is the collection of all calls linked to it. The description of each call in the context is indexed along with the text in the knowledge entry. This enables Analysts to find entries that may be relevant to a call by searching for words featured in the description of other calls that these entries have previously helped solve.

  8. Select the entry you want to view.

Other Search Options

You can add additional search options by selecting at the top of the Knowledge Search Criteria pane and configuring your search criteria. A description of some of the options (that is, attributes of knowledge entries) you can add is provided below.

Knowledge Ref

Select to search for a knowledge entry by its Reference Number.

This is a numeric field, and therefore you will not be able to specify letters (except D or K) or other characters in this field.

  • D retrieves external documents linked to knowledge entries.
  • K retrieves all knowledge entries.
Call No

Select to search for all entries linked to the specified call number.

External Ref

Select to return all entries that have this external reference number in the search results.

Entry Type

Select to return knowledge entries with a selected Entry Type. Select the required entry from the list.

Profile

Select this option to return knowledge entries with a specified Knowledge Profile. Select Equal to search for knowledge entries where the entry’s profile is the same as the profile selected. Select Equal + Below to search for Knowledge Entries within the Profile you have specified as well as knowledge entries within the lower tiers for the profile.

CMDB Item

Select to return knowledge entries related to a specified CMDB item. Use the Q/D button to locate the CMDB item for which you want to base your search.

Call Type

Select to return knowledge entries related to a specific issue type. Select Equal to search for Knowledge Entries where the entry’s type is the same as the type selected. Select Equal + Below to include lower tiers for the selected type in your search.

Entry Status

Select to return knowledge entries based on the selected status. Select a status from the Status list.

Contributor

Select to return knowledge entries based on the Analyst who is a contributor to those entries. Use the Q/D button to locate the contributor.

Last Updated

Select to return knowledge entries based on a specified Last Updated date.

Knowledge Entry Window

The knowledge entry window displays information about the question or issue you were searching for, and may also include links to relevant calls, websites, or other knowledge entries, and linked objects including CMDB Items.

Info Panel - reading mode

This contains the following information.

Entry Type

One of the seven Knowledge Base types

Knowledge Ref The unique reference number of the knowledge entry
Status The status of the knowledge entry
Profile The tiered knowledge profile
Type The issue type linked to the knowledge entry
Service Desk Hits The number of times the entry has been viewed by analysts
Portal Hits The number of times the entry has been viewed by users
Feedback Responses The number of people who have rated the entry for its quality and content
Feedback Rating The overall rating of the entry in terms of quality and content

Toolbar Buttons on the Knowledge Entry Window

A number of toolbar buttons are provided on this window, which enable you to print the entry, link it, etc.

A System Settings registry key can be configured to enable reviewing of knowledge entries that contain Unicode text on a non Unicode Oracle system. Contact Alemba® Support for more information.

Select To…

Open the Knowledge Entry Details window which displays the configuration details of the knowledge entry.

Depending on the permissions on your Knowledge Management security role, you will be able to edit the knowledge entry text and settings, view the Knowledge Report, provide feedback, and modify items linked to the entry.

Link the selected entry to the current call and copy the content of the entry to the Actions and Solutions field of the call.

This option is only enabled for knowledge entries created from a call.

If the knowledge entry is in HTML format, a text version of the entry is copied to the call.  If the entry is a text Call/Known Issue/FAQ, it will be copied to the call only if there is some content in the Solution/Workaround/Answer field.

Link the selected entry to the current call without copying the content through to the call.

This option is only enabled for knowledge entries created from a call.

Copy the content of the selected entry to the Actions and Solutions field of the current call without linking it to the call.

This option is only enabled for knowledge entries created from a call.

Send the entry to another Analyst or User via email. The Send Email window appears with the Subject line containing details of the entry type and ref. The body of the email displays the content of the knowledge entry.

Print the contents of the selected knowledge entry.

Search for a text string within the knowledge entry.

Feedback on a Knowledge Entry

You can give feedback on an entry, including rating for quality and content, flags for the entry to be reviewed and commented on. Any submitted feedback can be viewed via the Feedback Explorer Option on the Knowledge Bank window.

Before you start

You cannot give feedback on an entry if you have created or contributed to it.

  1. Scroll across/down to see the feedback area .
  2. In response to the question How would you rate the quality and content of this entry?, select one of the available ratings.
  3. Select the Review Required checkbox if you would like the entry to be reviewed. Entries flagged for review are still be available for viewing and editing by analysts with appropriate permissions.
  4. Once an entry has been flagged as requiring review, the Review Required checkbox will no longer be displayed.

  5. Use the Comments box to provide more information on the feedback rating you have selected or the reason for selecting the Review Required option.
  6. Select OK to save the feedback. The information panel is updated with the feedback information. If you have requested a review, the message at the bottom of the pane.